feat(@netlify/vite-plugin-react-router): add edge support #562

serhalp · 2025-10-28T22:00:14Z

Summary

This PR adds opt-in support for deploying React Router 7 apps to Netlify Edge Functions (Deno runtime) via the edge: boolean plugin option. Previously, the plugin only supported Netlify Functions (Node.js runtime).

Toward FRB-1519

Changes

Add edge?: boolean option to Vite plugin factory
When edge is enabled:
- Configure Vite SSR build with target: 'webworker' and other Deno-compatible build config
- Generate an edge function in .netlify/v1/edge-functions/, instead of a function .netlify/v1/functions/
Add excludedPaths?: string[] option to allow users to exclude paths from the React Router handler. Required when using edge: true and the project also has its own Netlify Functions with a configured path, otherwise only the RR handler runs on all dynamic paths.

Testing

Unskip the RR7 edge e2e suite
Add a few tests I noticed were missing for edge (or vice versa)
I thought I'd add tests to ensure prerendering works while I was here (this was added in RR7 but did not exist in Remix 2)... but unfortunately I discovered that this does not in fact work. I left the tests and marked them as failing.
You can also link this locally with https://github.com/netlify/react-router-template/ and confirm it works ✅

Documentation

I added complete documentation for opting in (and back out of) edge deployment.

Implementation

Edge support is more involved than regular serverless functions for three main reasons:

EFs don't have a preferStatic option like NFs.
- Instead, to avoid needlessly running compute to serve static assets, we must populate the EF's excludedPath with all published client assets. This skips the EF entirely for these paths.
Although there is a precise processing order for EFs and for NFs, all EFs run before any NF.
- This means that since our generated EF runs on path: '/*', if a user has their own NF with path: '/foo', our EF will run first and render a response from React Router and the user's NF will never run.
- To that end, this PR adds and documents an excludedPaths?: [] option to the plugin.
- There were various alternative solutions here, but this seemed like a reasonable approach for now.
React Router 7 contains only a single default built-in server entry and this assumes a Node.js environment.
- Unfortunately, this means when using edge: true the user must include their own app/entry.server.tsx that uses renderToReadableStream instead of renderToPipeableStream.
- There may be some magic we can implement here to make this work out of the box. It didn't seem worth it to me to fight against the framework here. We can also always add this later.

netlify · 2025-10-28T22:00:20Z

✅ Deploy Preview for remix-edge ready!

Name	Link
🔨 Latest commit	`f2fa84d`
🔍 Latest deploy log	https://app.netlify.com/projects/remix-edge/deploys/690b7fb266802600081ce233
😎 Deploy Preview	https://deploy-preview-562--remix-edge.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify · 2025-10-28T22:00:20Z

✅ Deploy Preview for remix-serverless ready!

Name	Link
🔨 Latest commit	`f2fa84d`
🔍 Latest deploy log	https://app.netlify.com/projects/remix-serverless/deploys/690b7fb2069c55000868a3fd
😎 Deploy Preview	https://deploy-preview-562--remix-serverless.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

When the globally installed deno cli isn't a supported version, the build automatically tries to install a local binary. Unfortunately when running multiple builds concurrently on the same machine with default configuration, there's a race condition where a binary tries to get written to the same path where one is currently running, leading to an OS error. Just install the correct version globally. See (internal link) https://netlify.slack.com/archives/C03ETTLQ9BP/p1761826639264259

it turns out... > By default, tag-based purges apply to all of the site’s deploys. To target a specific deploy, > specify one or more of the following [...] from https://docs.netlify.com/build/caching/caching-overview/#use-a-function-with-the-purgecache-helper-to-purge-by-cache-tag Whoops. So concurrent tests were conflicting with one another's expectations.

serhalp · 2025-10-30T18:14:02Z

packages/vite-plugin-react-router/src/lib/context.ts

File extracted as-is. Only change is the TNetlifyContext generic, so that NFs and EFs can pass in their own slightly different context types.

serhalp · 2025-10-30T18:15:06Z

packages/vite-plugin-react-router/src/lib/handler.ts

Most of this file was extracted as is. The only change is the context generic and the runtimeName arg.

serhalp · 2025-10-30T18:23:52Z

packages/vite-plugin-react-router/package.json

+    "./function-handler": {
+      "types": "./dist/function-handler.d.mts",
+      "default": "./dist/function-handler.mjs"
+    },
+    "./edge-function-handler": {


Check out the first lines of FUNCTION_HANDLER and EDGE_FUNCTION_HANDLER to understand what these are for. They're the runtime entry points.

(This should probably always have been an explicit separate export, honestly.)

serhalp · 2025-10-30T18:25:30Z

packages/vite-plugin-react-router/README.md

+> required for the Deno runtime. You may customize your server entry file, but see below for important edge runtime
+> constraints.
+
+```tsx


identical to the Cloudflare one in the RR7 codebase... https://github.com/remix-run/react-router/blob/cb9a090316003988ff367bb2f2d1ef5bd03bd3af/integration/helpers/vite-plugin-cloudflare-template/app/entry.server.tsx

serhalp · 2025-10-30T18:28:19Z

tests/e2e/fixtures/react-router-edge-site/app/routes/about.tsx

this whole fixture is pretty much identical to the react-router-serverless-site one. I just removed durable, added app/entry.server.tsx, and passed in edge: true and excludedPaths in the vite config.

tests/e2e/fixtures/react-router-edge-site/netlify.toml

tests/e2e/fixtures/react-router-edge-site/package.json

tests/e2e/fixtures/react-router-serverless-v8-middleware/package.json

When a test retries, it reuses the deployed fixture and since the cache state is preserved from the previous run, the initial state is incorrect. Attaching a unique query string per run isolated each run.

There appears to still be some flakiness that I cannot reproduce when running `.only` on a test, which implies that there's somethhing conflicting somehow across tests running concurrently.

packages/vite-plugin-react-router/src/index.ts

packages/vite-plugin-react-router/src/plugin.ts

and document a pattern for using `netlifyRouterContext` in edge

.github/workflows/publint.yml

packages/vite-plugin-react-router/tsup.config.ts

packages/vite-plugin-react-router/src/plugin.ts

By declaring the ESM entries together, we allow code splitting, which keeps the size of our package to a minimum.

This reverts commit 8f54892. It turns out it's the docs that are wrong :(

D'oh. The cache purge calls in the e2e tests were 404ing...

Turns out we had the same problem here as well.

…-react-router-7

This reverts commit 9ba3231.

github-actions bot added the type: feature code contributing to the implementation of a feature and/or user facing functionality label Oct 28, 2025

feat(vite-plugin-react-router): add edge support

b552eb6

serhalp force-pushed the serhalp/frb-1519-support-edge-rendering-with-react-router-7 branch from 5b9a00c to b552eb6 Compare October 29, 2025 00:11

serhalp added 3 commits October 29, 2025 14:30

test: add RR7 prerender tests

0286e3c

fix: add mechanism to support user NFs

2f24fb1

chore(deps): upgrade to latest netlify-cli

596e1d6

serhalp force-pushed the serhalp/frb-1519-support-edge-rendering-with-react-router-7 branch from 744b059 to 7fde98c Compare October 30, 2025 13:55

serhalp added 2 commits October 30, 2025 10:03

serhalp force-pushed the serhalp/frb-1519-support-edge-rendering-with-react-router-7 branch from 7fde98c to 78d1afe Compare October 30, 2025 14:03

serhalp added 2 commits October 30, 2025 10:37

fix: simplify unnecessary edge vite config

6b91c38

refactor: extract shared edge/origin handler code

dfb7f5b

serhalp commented Oct 30, 2025

View reviewed changes

tests/e2e/fixtures/react-router-edge-site/netlify.toml Outdated Show resolved Hide resolved

serhalp commented Oct 30, 2025

View reviewed changes

tests/e2e/fixtures/react-router-edge-site/package.json Outdated Show resolved Hide resolved

serhalp commented Oct 30, 2025

View reviewed changes

tests/e2e/fixtures/react-router-serverless-v8-middleware/package.json Outdated Show resolved Hide resolved

serhalp and others added 4 commits October 30, 2025 16:35

test: fix incorrect assertion

9790bd6

test: de-flake cache tests by isolating retries

a512374

When a test retries, it reuses the deployed fixture and since the cache state is preserved from the previous run, the initial state is incorrect. Attaching a unique query string per run isolated each run.

refactor: clean up minor gunk

f672e85

test: fix edge cache assertion again

db17f6c

serhalp marked this pull request as ready for review October 30, 2025 20:53

serhalp requested a review from a team as a code owner October 30, 2025 20:53

serhalp added 2 commits October 31, 2025 08:49

test: assert purge calls succeed

e5d9436

build: disable in-suite parallelization

9ba3231

There appears to still be some flakiness that I cannot reproduce when running `.only` on a test, which implies that there's somethhing conflicting somehow across tests running concurrently.

pieh reviewed Oct 31, 2025

View reviewed changes

packages/vite-plugin-react-router/src/index.ts Outdated Show resolved Hide resolved

pieh reviewed Oct 31, 2025

View reviewed changes

packages/vite-plugin-react-router/src/plugin.ts Show resolved Hide resolved

serhalp added 2 commits October 31, 2025 16:32

build: add publint npm package validation

ee4f0b4

fix: rework edge vs. serverless code organization

c6d75cb

and document a pattern for using `netlifyRouterContext` in edge

serhalp force-pushed the serhalp/frb-1519-support-edge-rendering-with-react-router-7 branch from fafc121 to c6d75cb Compare October 31, 2025 20:39

github-advanced-security bot found potential problems Oct 31, 2025

View reviewed changes

.github/workflows/publint.yml Fixed Show fixed Hide fixed

serhalp added 2 commits October 31, 2025 16:42

fix: actually include human friendly name on Function

8f54892

ci: fix new publint workflow

e30660a

pieh reviewed Nov 3, 2025

View reviewed changes

packages/vite-plugin-react-router/tsup.config.ts Show resolved Hide resolved

pieh reviewed Nov 3, 2025

View reviewed changes

packages/vite-plugin-react-router/src/plugin.ts Outdated Show resolved Hide resolved

serhalp added 5 commits November 3, 2025 15:18

build: allow code ESM splitting

f726914

By declaring the ESM entries together, we allow code splitting, which keeps the size of our package to a minimum.

Revert "fix: actually include human friendly name on Function"

6a26dd9

This reverts commit 8f54892. It turns out it's the docs that are wrong :(

build: fix build setup regression

eb018ee

test: fix RR7 edge fixture

47dd051

D'oh. The cache purge calls in the e2e tests were 404ing...

fix: backport fix from 2f24fb1 to @netlify/remix-edge-adapter

3beb85c

Turns out we had the same problem here as well.

serhalp force-pushed the serhalp/frb-1519-support-edge-rendering-with-react-router-7 branch from df6e147 to 3beb85c Compare November 4, 2025 00:10

serhalp added 3 commits November 5, 2025 10:58

Merge branch 'main' into serhalp/frb-1519-support-edge-rendering-with…

4d68d17

…-react-router-7

Revert "build: disable in-suite parallelization"

4b56e4d

This reverts commit 9ba3231.

test: remove tiny cruft from fixture

f2fa84d

serhalp requested a review from pieh November 5, 2025 16:56

pieh approved these changes Nov 5, 2025

View reviewed changes

serhalp merged commit bbcb41e into main Nov 5, 2025
17 checks passed

serhalp deleted the serhalp/frb-1519-support-edge-rendering-with-react-router-7 branch November 5, 2025 17:17

token-generator-app bot mentioned this pull request Nov 5, 2025

chore: release main #564

Merged

serhalp mentioned this pull request Nov 5, 2025

fix(@netlify/vite-plugin-react-router): fix local dev with edge: true #572

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(@netlify/vite-plugin-react-router): add edge support #562

feat(@netlify/vite-plugin-react-router): add edge support #562

Uh oh!

serhalp commented Oct 28, 2025 •

edited

Loading

Uh oh!

netlify bot commented Oct 28, 2025 •

edited

Loading

Uh oh!

netlify bot commented Oct 28, 2025 •

edited

Loading

Uh oh!

serhalp Oct 30, 2025

Uh oh!

serhalp Oct 30, 2025 •

edited

Loading

Uh oh!

serhalp Oct 30, 2025

Uh oh!

serhalp Oct 30, 2025

Uh oh!

serhalp Oct 30, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

feat(@netlify/vite-plugin-react-router): add edge support #562

feat(@netlify/vite-plugin-react-router): add edge support #562

Uh oh!

Conversation

serhalp commented Oct 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Testing

Documentation

Implementation

Uh oh!

netlify bot commented Oct 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for remix-edge ready!

Uh oh!

netlify bot commented Oct 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for remix-serverless ready!

Uh oh!

serhalp Oct 30, 2025

Choose a reason for hiding this comment

Uh oh!

serhalp Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

serhalp Oct 30, 2025

Choose a reason for hiding this comment

Uh oh!

serhalp Oct 30, 2025

Choose a reason for hiding this comment

Uh oh!

serhalp Oct 30, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

serhalp commented Oct 28, 2025 •

edited

Loading

netlify bot commented Oct 28, 2025 •

edited

Loading

netlify bot commented Oct 28, 2025 •

edited

Loading

serhalp Oct 30, 2025 •

edited

Loading